#Claude Code 问题排查技能

#问题背景

在日常开发中，调试占据了大量时间。面对 bug，常见的做法是凭直觉猜测原因，快速尝试修复，不行就换一个方向再试。这种「试错法」看似高效，实际上经常导致：

• 修复了表面症状，根因仍在，问题反复出现
• 一次改多处，引入新 bug，问题越改越多
• 连续尝试多次修复失败，浪费大量时间

flowchart LR
    A[发现 Bug] --> B{凭直觉猜测}
    B --> C[尝试修复 1]
    C --> D{解决了？}
    D -- 没有 --> E[尝试修复 2]
    E --> F{解决了？}
    F -- 没有 --> G[尝试修复 3...]
    G --> H[耗时数小时<br/>可能引入新问题]
    D -- 是 --> I[可能只修了表象]

#解决方案：Systematic Debugging 技能

Systematic Debugging（系统化调试）是 Superpowers 技能库中的核心技能之一，它将软件工程中的根因分析方法论转化为 Claude Code 的强制工作流程。

核心原则：先找根因，再做修复。没有完成调查，不允许提出修复方案。

#安装

npx skills add https://github.com/obra/superpowers --skill systematic-debugging

#适用场景

该技能适用于所有技术问题，不仅限于代码 bug：

#四阶段排查流程

Systematic Debugging 将调试过程分为四个强制阶段，必须按顺序完成，不能跳过。

flowchart LR
    A[阶段 1<br/>根因调查] --> B[阶段 2<br/>模式分析]
    B --> C[阶段 3<br/>假设验证]
    C --> D[阶段 4<br/>实施修复]
    D -- 修复失败<br/>不超过3次 --> A
    D -- 3次修复失败 --> E[停下来<br/>质疑架构]

#阶段 1：根因调查

这是最关键的阶段。在完成根因调查之前，不允许提出任何修复方案。

#阶段 2：模式分析

找到已有的正确实现，通过对比发现差异。

#阶段 3：假设与验证

采用科学方法，逐一验证假设。

#阶段 4：实施修复

确认根因后，针对性地修复。